home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / MacOS 8 Resources / Developer Tools / Mac OS 8 Interfaces & Libraries / Interfaces / IDLIncludes / Synchronization.idl < prev    next >
Encoding:
Text File  |  1996-05-01  |  2.3 KB  |  81 lines  |  [TEXT/MPS ]
  1. /*
  2.      File:        Synchronization.idl
  3.  
  4.      Contains:    Synchronization Interfaces
  5.  
  6.      Version:    Technology:    System 8
  7.                  Release:    Universal Interfaces 3.0d3 on Copland DR1
  8.  
  9.      Copyright:    © 1984-1996 by Apple Computer, Inc.  All rights reserved.
  10.  
  11.      Bugs?:        If you find a problem with this file, send the file and version
  12.                  information (from above) and the problem description to:
  13.  
  14.                      Internet:    apple.bugs@applelink.apple.com
  15.                      AppleLink:    APPLE.BUGS
  16.  
  17. */
  18. #ifndef __SYNCHRONIZATION_IDL__
  19. #define __SYNCHRONIZATION_IDL__
  20.  
  21. #include <somobj.idl>
  22. #include <somcls.idl>
  23.  
  24. #ifndef __TYPES_IDL__
  25. #include <Types.idl>
  26. #endif
  27. #ifndef __KERNEL_IDL__
  28. #include <Kernel.idl>
  29. #endif
  30.  
  31. #ifdef __SOMIDL__
  32.  
  33. #if FOR_SYSTEM8_PREEMPTIVE
  34. /* Note:  Lock, ReadWriteLock, and CountingSemaphore data structures must be LONG WORD ALIGNED in memory!*/
  35. typedef SOMLargeStruct            Lock;                        /* Derived from a struct of 8 bytes in size */
  36.  
  37. typedef OpaquePtr                LockPtr;                    /* Substituted OpaquePtr for “Lock*” */
  38.  
  39. typedef SOMLargeStruct            ReadWriteLock;                /* Derived from a struct of 20 bytes in size */
  40.  
  41. typedef OpaquePtr                ReadWriteLockPtr;            /* Substituted OpaquePtr for “ReadWriteLock*” */
  42.  
  43. typedef SOMLargeStruct            CountingSemaphore;            /* Derived from a struct of 24 bytes in size */
  44.  
  45. typedef OpaquePtr                CountingSemaphorePtr;        /* Substituted OpaquePtr for “CountingSemaphore*” */
  46.  
  47. typedef OptionBits                LockOptions;
  48.  
  49. typedef OpaquePtr                InterruptState;                /* Substituted OpaquePtr for “void*” */
  50.  
  51. /*
  52.  Simple lock routines
  53.  Locks may be created with the kLockDisablesSwis and/or kLockDisablesCompletionRoutines options,
  54.  but no others.
  55. */
  56. /*
  57.  Reader/writer lock routines
  58.  ReadWriteLocks may be created with the kLockDisablesSwis, kLockDisablesCompletionRoutines,
  59.  and/or kLockAdjustsPriorities options.
  60. */
  61. /*
  62.  Counting semaphore routines
  63.  CountingSemaphores currently have no options.
  64. */
  65. /*
  66.  Interrupt enabling and disabling.  ** MAY ONLY BE CALLED FROM PRIVILEGED CODE!!! **
  67.  Use very sparingly.
  68. */
  69. /*
  70.  Atomic operations on 8-, 16-, and 32-bit entities.
  71.  ** OPERATIONS THAT CROSS WORD (32-BIT) BOUNDARIES WILL FAIL!!! **
  72. */
  73. /* Note: TestAndSet uses PPC bit ordering, zero is the high bit, and theBit ranges from 0 - FFFFFFFF.*/
  74. /* Atomic primitives for singly linked list manipulation.*/
  75. #endif
  76.  
  77. #endif /* __SOMIDL__ */
  78.  
  79. #endif /* __SYNCHRONIZATION_IDL__ */
  80.  
  81.